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LICENSE 



PLEASE READ THIS LICENSE CAREFULLY BEFORE USING THE SOFTWARE. BY USING THE SOFTWARE, YOU ARE 
AGREEING TO BE BOUND BY THE TERMS OF THIS LICENSE. IF YOU DO NOT AGREE TO THE TERMS OF THIS 
LICENSE, PROMPTLY RETURN THE UNUSED SOFTWARE TO THE PLACE WHERE YOU OBTAINED IT AND YOUR 
MONEY WILL BE REFUNDED. 

1. License. The software accompanying this License {the "Software") and related documentation are licensed to you by 
WestCode Software, Inc. ("WestCode"). You own the disk on which the Software Is recorded but WestCode and/or 
WestCode's Licensor(s) retain title to the Software and related documentation. This License allows you to use the Software 
on a single computer and make one copy of the Software in machine-readable form for backup purposes only You may also 
transfer all your license rights in the Software, including subsequent updates, the backup copy of the Software, the related 
documentation and a copy of this License to another party, provided the other party reads and agrees to accept the terms 
and conditions of this License. 

2. Restrictions. The Software contains copyrighted material, trade secrets and other proprietary material and in order to 
protect them you may not decompile, reverse engineer, disassemble or otherwise reduce the Software to a human- 
perceivable form. You may not modify network, rent, lease, loan, distribute or create derivative works based upon the 
Software in whole or in part. You may not electronically transmit the Software from one computer to another or over a 
network. Contact WestCode for a separate network license. 

3. Termination. This License is effective until terminated. You may terminate this License at any time by destroying the 
Software and related documentation and all copies thereof. This License will terminate immediately without notice from 
WestCode if you fail to comply with any provision of this License. Upon termination you must destroy the Software and 
related documentation and all copies thereof. 

4. Export Law Assurances. You agree and certify that neither the Software nor any other technical data received from 
WestCode, nor the direct product thereof, will be exported outside the United States except as authorized and as permitted 

by the laws and regulations of the United States. 

5. Government End Users. If you are acquiring the Software on behalf of any unit or agency of the United States 
Government, the following provisions apply The Government agrees: 

(i) if the Software is supplied to the Department of Defense (DoD), the Software is classified "Commercial 
Computer Software" and the Government is acquiring only "restricted rights" in the Software and its 
documentation as that term is defined in Clause 252.227-701 3(c)(1) of the DFARS; and 

(ii) if the Software is supplied to any unit or agency of the United States Government other than DoD, the 
Government's rights in the Software and its documentation will be as defined in Clause 52.227-1 9(c)(2) of the 
FAR or, in the case of NASA, in Clause 18-52.227-86(d) of the NASA Supplement to the FAR. 

6. Limited Warranty on IVIedia. WestCode warrants the disks on which the Software is recorded to be free from defects in 
materials and workmanship under normal use for a period of ninety (90) days from the date of purchase as evidenced by a 
copy of the receipt. WestCode's entire liability and your exclusive remedy will be replacement of the disk not meeting 
WestCode's limited warranty and which is returned to WestCode or a WestCode authorized representative with a copy of 
the receipt. WestCode will have no responsibility to replace a disk damaged by accident, abuse or misapplication. ANY 
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IMPLIED WARRANTIES ON THE DISKS, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE, ARE LIMITED IN DURATION TO NINETY (90) DAYS FROM THE DATE OF 
DELIVERY THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS, AND YOU MAY ALSO HAVE OTHER RIGHTS 
WHICH VARY FROM STATE TO STATE. 

7. Disclaimer of Warranty on Software. You expressly acknowledge and agree that use of the software is at your sole 
risk. The Software and related documentation are provided "AS IS" and without warranty of any kind and WestCode and 
WestCode's Licensor(s) (for the purposes of provisions 7 and 8, WestCode and WestCode's Licensor(s) shall be 
collectively referred to as "WestCode") EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. WESTCODE DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE 
SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE 
UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE WILL BE CORRECTED. 
FURTHERMORE, WESTCODE DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE 
OR THE RESULTS OF THE USE OF THE SOFTWARE OR RELATED DOCUMENTATION IN TERMS OF THEIR 
CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. NO ORAL OR WRITTEN INFORMATION OR ADVICE 
GIVEN BY WESTCODE OR A WESTCODE AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN 
ANYWAY INCREASE THE SCOPE OF THIS WARRANTY SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND 
NOT WESTCODE OR A WESTCODE AUTHORIZED REPRESENTATIVE) ASSUME THE ENTIRE COST OF ALL 
NECESSARY SERVICING, REPAIR OR CORRECTION. SOME STATES DO NOT ALLOW THE EXCLUSION OF 
IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. 

8. Limitation of Liability. UNDER NO CIRCUMSTANCES INCLUDING NEGLIGENCE SHALL WESTCODE BE 
LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES THAT RESULT FROM THE USE OR 
INABILITY TO USE THE SOFTWARE OR RELATED DOCUMENTATION, EVEN IF WESTCODE OR A WESTCODE 
AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBLILITY OF SUCH DAMAGES. SOME 
STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL 
DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. 

In no event shall WestCode's total liability to you for all damages, losses, and causes of action (whether In contract, tort 
(including negligence) or otherwise) exceed the amount paid by you for the Software. 

9. Controlling Law and Severability. This License shall be governed by and construed in accordance with the laws of 
the United States and the State of California, as applied to agreements entered into and to be performed entirely within 
California between California residents. If for any reason a court of competent jurisdiction finds any provision of this 
License, or portion thereof, to be unenforceable, that provision of the License shall be enforced to the maximum extent 
permissible so as to effect the Intent of the parties, and the remainder of this License shall continue in full force and effect. 

10. Complete Agreement. This License constitutes the entire agreement between the parties with respect to the use of 
the Software and related documentation, and supersedes all prior or contemporaneous understandings or agreements, 
written or oral, regarding such subject matter. No amendment to or modification of this License will be binding unless In 
writing and signed by a duly authorized representative of WestCode. 
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Welcome to HardPressed 

TM 

HardPressed is a powerful system extension that incorporates automatic file 
compression and expansion into the GS/OS system software. With HardPressed 
installed, you can virtually double the amount of free space on your disks. By 
compressing the files already on your disks— applications, databases, documents, 
spreadsheets, utilities, and anything else— you don't need to buy a larger hard disk or 
another floppy disk drive to hold more files. 

The HardPressed software is a small application, called an INIT, that automatically 
loads when you start up your Apple IIGS. It operates in the background, compressing 
and expanding files as you save and open your documents and applications. In the 
Finder, your fiiles still appear with their normal file type, only they're smaller. You can 
continue to use your documents and applications as you normally would— when you 
open a compressed file or launch a compressed application, HardPressed automatically 
expands the file for you. You don't need to "extract" them fiirst like you do with other 
compression utilities, such as Shrinklt. 

HardPressed also comes with a control panel device (CDev) that lets you choose which 
folders and disks you want compressed automatically. And if you want to compress or 
expand files manually, the HardPressed Finder extension lets you do so by just 
selecting icons and choosing a command from a Finder menu. 



Customer Support 

At WestCode Software our company "mission" is to create outstanding, innovative 
products. This package reflects our dedication to producing well-designed software 
combined with comprehensive and educational user documentation that helps you get 
the most from your purchase. 
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Our goal is to ensure that you're satisfied with our products and service. If you ever 
have a question or problem with one of our products, and you can't find an answer in 
the manual, call us for a quick solution. Our knowledgeable and fiiendly technical 
support staff is available to help you from 10:00 A.M. to 5:00 P.M. Pacific time, Monday 
through Friday. Call or write to: 

(619) 487-9233 Technical questions about products 
(619) 487-9200 General information and sales 
(619) 487-9255 Fax 

WestCode Software, Inc. 

Attn: Technical Support 

15050 Avenue of Science, Suite 112 

San Diego, CA 92128 

When calling, you should be at your computer, have this manual handy, and be 
prepared to give the following information: 

■ The Product Registration number on the inside cover of this manual 

■ Your hardware setup (computer type, memory, and so on) 

■ The version of your system software 

■ A description of the problem 

Modem users can also receive product support on America Online (keyword: APR) and 
GEnie (A2 bulletin board), e-mail: WestCode. 

Registration 

Please take a moment now to complete the Registration Card included with this 
package. Registration will allow us to notify you of product improvements and to tell 
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you about new products. It only takes a few minutes to fill out and mail the card, so 
please do it now. Remember, product support is available only to registered users. 

Customer Comments 

We're always looking for ways to improve our products and frequently add new 
features requested by our customers. We welcome and encourage your comments for 
making our products and service even better. We're also interested in ideas for new 
products that you'd like to see produced. 

System Requirements 

To use HardPressed you'll need the following: 

■ An Apple IlGS with a minimum of 1.25 megabytes (1280K) of memory; 2 megabytes 
are required if you don't have a hard disk drive. Additional memory is 
recommended to increase performance. 

■ Apple IlGS system software version 6.0 or newer 
Optional: 

■ Hard disk drive (recommended) 

■ Accelerator card 

HardPressed requires System 6.0 or newer If you're not sure which version of the 
system software you have, look at the GS/OS startup screen (the screen that says 
"Welcome to the Apple IlGS"). If it says "System 6.0" below "Welcome to the Apple 
IlGS", then you have System 6.0. If it doesn't say "System 6.0", you have an earlier 
version. 
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What's in this Package 

The following items should be in your HardPressed package: 

■ One 800K 3.5-inch disk 

■ HardPressed User's Manual (this book) 

■ Registration and Change of Address cards 

About this Manual 

If you are the type that likes to explore and start using software without first reading 
the manual, feel free to skip ahead to Installing HardPressed on page 11, which 
explains how to install HardPressed on your startup disk. 

Once you have installed HardPressed, read Using HardPressed on page 19. In a brief 
tutorial, you'll learn how to mark folders for automatic compression, how to manually 
compress and expand files, and how to turn HardPressed on and off 

We strongly suggest that once you've seen HardPressed in action, you should return to 
this manual and read the following reference chapters completely. 

■ Chapter 4, The HardPressed Control Panel, shows you how to mark folders for 
automatic compression and set other options. 

■ Chapter 5, The HardPressed Finder Extension, shows you how to compress and 
expand files you select in the Finder. 

■ Chapter 6, The HardPressed Control Desk Accessory, shows you how to turn the 
automatic compression features on and off from within any GS/OS application. 

■ Appendix A, Compressing System Files, shows you which system files you can safely 
compress and which fiiles you should not compress. 
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■ Appendix B, Trouble-shooting, lists common questions and answers you may have 
about HardPressed. It explains error messages you may encounter and lists some 
applications that are not 100% compatible with HardPressed. If you use ProSel-16, 
it's very important that you read this section. 

■ Appendix C, Technical Information, includes technical descriptions of the 
compression methods used by HardPressed. It isn't necessary for you to read this 
section; it's included only as a technical reference. 

This manual contains some technical information about the HardPressed software, data 
compression, and GS/OS. You don't need to understand the technical aspects of 
HardPressed to use it, but Appendix C provides that technical information nonetheless. 
If you read this entire manual, you'll understand how and why HardPressed works. 

Do You Know the Basics? 

This manual assumes that you are comfortable working with your computer and know 
how to select menu items, open files, click on buttons and so forth. If terms such as 
double-click, icons and system software are new to you, please refer to the manuals 
that came with your computer. 

About Data Compression 

Before getting started with HardPressed, please take a few moments to learn how 
HardPressed works. In the following sections, we'll tell you about data compression, 
how HardPressed integrates with GS/OS, and the kind of performance you can expect 
while using the program. 
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Automatic, Intelligent Compression 

HardPressed allows both automatic and manual compression of your files. For 
automatic compression, you can select which disks and folders are compressed 
automatically by marking disks and folders in the HardPressed control panel. When 
you create or save files in any marked folder, HardPressed compresses the file after it's 
saved. HardPressed also compresses any files you copy fi-om another disk into a marked 
folder. You can think of this automatic compression as "compression by location." 

Using a compression profile you select in the control panel, HardPressed decides which 
compression module would work best on the file it's compressing, based on the file's 
ProDOS file type. Choosing a profile allows you to select greater compression with a 
loss of speed, or greater speed with less compression. 

Manual Compression with New Finder Commands 

When you want to compress or expand files manually, you can use the new Compress 
and Expand commands in the Finder's Extras menu added by the HardPressed Finder 
extension. Now, compressing or expanding a file is as easy as selecting an icon and 
choosing a command— you don't need to launch an application, such as Shrinkit, to 
manage your compressed files. 

The HardPressed Finder extension also includes a Compression Info command, which 
shows you the actual, uncompressed size of a compressed file and how much disk 
space the compressed file saves. 

How HardPressed Makes Files Smaller 

Data compression works by examining a file's contents and encoding it into a smaller 
format. A graphic, for example, may be stored as color information for each screen 



■ 7 



ONE 



INTRODUCTION 



pixel. A graphic containing 10 pixels of red, followed by 5 pixels of green, then 7 pixels 
of blue can be represented by the following color data: 

RRRRRRRRRRGGGGG BBBBBBB 

The color information requires 22 bytes, one byte for each screen pixel. Using a simple 
compression technique, the data can be compressed by replacing each series of 
repeating bytes with the number of bytes followed by the actual color information. 
Using compression, the data uses only six bytes instead of 22: 

10 R 5 G 7 B 

The example above is a rather simple method of data compression, but it gives you an 
idea of how compression works. HardPressed uses a few other, more complex methods 
to compress different kinds of files, such as applications and word processing 
documents. The different compression methods are described in Appendix C— 
Technical Information on page 73. 

Because of the way compression works (by removing redundant data), the amount of 
compression achieved is highly dependent on the type of data you compress. Data with 
a lot of redundancy (such as bit-mapped graphics) compress very well, while more 
random data (such as applications) don't compress as well. Text files usually land 
somewhere in the middle. 

The Space and Time Trade-off 

Compressing a fiile to make it smaller is a processor-intensive task. Generally, 
compression methods that compress tightly take longer to process a fiile than methods 
that provide less compression. HardPressed provides several different compression 
methods, contained in compression modules, that offer different levels of speed and 
compression. For example, the LZW module provides adequate compression at a 
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moderate speed. The LZSS module provides greater compression, but files take longer 
to compress. 

The performance of different compression modules also differs in the time it takes to 
expand a file. Files compressed with the LZW module are expanded at a moderate 
speed, but fiiles compressed with the LZSS module can be expanded two to three times 
faster than files compressed with the LZW module. 

If you have an accelerator card installed in your computer, the different speeds of the 
compression modules may not make much difference to you. However, if your IIGS is 
running at normal speed, you may want to consider which compression modules 
HardPressed uses to compress your files. By selecting a compression profile, you can 
choose whether HardPressed provides greater compression with a loss of speed, or 
greater speed with less compression. 

How HardPressed Works with GS/OS 

When you launch a compressed application or open a compressed document, 
HardPressed automatically expands the file for you. HardPressed expands the file into a 
temporary fiile in its file cache, a place in memory that HardPressed uses to store files 
it's working on. After HardPressed expands a file, your application reads the data from 
the file cache instead of the original file, which remains compressed. When you save a 
file in a marked folder, HardPressed first compresses the data into the file cache, then 
replaces the original file with the compressed copy. 

If there isn't enough memory in the file cache to hold the file, HardPressed creates a 
temporary file on a disk. You can use the HardPressed control panel to set the size of 
the file cache (or turn it off completely), and to choose where temporary files are 
stored. 
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HardPressed stores compressed files as HardPressed data files with the "archival 
library" file type. However, your files still appear with their original type in the Finder 
and other GS/OS applications— HardPressed fools GS/OS into always displaying a file's 
original type. Of course, if you make HardPressed inactive or remove it from your 
system, your compressed files will appear as archival library files and your applications 
won't be able to access them. 



Installing HardPressed 

Now that you've learned about data compression and how HardPressed works, you're 
ready to start using it. The next chapter explains how to install HardPressed. The 
installation process takes only a few minutes. 
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This chapter explains how to install HardPressed 
on to your IIGS system disk. Once HardPressed is 
installed, it works as a built-in component of the 
IIGS system software, transparently operating 
behind the scenes to compress and expand files 
as you open and save your documents and 
applications. 
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The HardPressed Disk 



HardPressed is supplied on a single 800K disk. Included on the disk is an easy-to-use 
Install program, the HardPressed software, and a file containing release notes. 



! HardPressed! 



ProDOS 



S items 72gK used 71K free 



ReadHe 



Q 

Install HardPressed 



CD 



Icons 



Practice Goodies 



CD CD 

System. Files Install. Files 



The HardPressed folder contains the HardPressed software: the control panel 
device (CDev), the HardPressed Finder extension, the HardPressed initialization 
file (INIT), and a variety of compression modules that HardPressed uses to 
compress different kinds of files. 

The Practice folder contains three files you'll use during the tutorial in the next 
chapter. It contains the Teach application, a text file, and a graphic file. 

The System.Files folder contains compressed versions of several system files used 
to install HardPressed onto an 800K system disk. 

The Install.Files folder contains files needed during the installation process. 

The Icons folder contains Finder icons for all of the HardPressed files. 

The Goodies folder contains technical information about HardPressed for those 
who are interested. The Goodies.Readme file in the Goodies folder contains a 
summary of the folder's contents. 
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Release Notes 

On the HardPressed disk you will find a text file named ReadMe. Please read this file 
before continuing; it may contain information about new features in HardPressed that 
we added after this manual was printed. Double-click the ReadMe icon to open it using 
Teach, or use any text editor to read the file. 

Using the Install Program 

The HardPressed disk itself is not a bootable disk. In order to install HardPressed, it will 
be necessary for you to start up from your hard disk or a IIGS system disk. 

1 Run the Install program on the HardPressed disk by double-clicking the Install icon. 



■llllllllH HardPressed™ Installer 

IBI Copyright 1993 By fllan Bird 

■■■I IflestCode Software 

Home: 



Organization: 



[ Cancel J [PersonalizeJ 

Enter your name and/or organization, 
then select the Personalize button. 



The first time you use the Install program, you must personalize your original 
HardPressed disk before you can continue with the installation. 

2 After the personalization window appears, type your name in the first box. 
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3 Press Tab to move to the second box and type your organization's name. 

4 Click Personalize to continue. 




Remember that HardPressed is licensed for use on a single computer. 

If you plan to use HardPressed on a network or on several computers, contact WestCode 
Software to obtain a network or site license. 



After personalizing your HardPressed disk, the Apple IIGS Installer window appears. 



Disk to update: :Startup.Disk 




(Hi Startup. Disk 


1 HardPressed 




[ Install ] 
C Remove ] 
[ Help ] 






HardPressed on a 3.5" System disk 


llprint.P SplPrtinn L 1""' J Bpplirnt.inn FnlriPK fiplprt.inn 

Please select the desired update and the ( Disk );( i)!m ) 

LuilKLif nr fnlrfpr whprp ynii wnnt. t.n irmt.nll 

the update. ( SJwit ) i 0*™ 



5 If the upper left corner of the window doesn't show your startup disk's name, click the 
Disk button until your startup disk's name appears. 

There are two choices in the list on the left: 

■ HardPressed installs the HardPressed software onto the hard disk (or hard disk 
partition) containing your System folder. 
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■ HardPressed on a 3.5" System Disk installs HardPressed onto an 800K startup 
disk. Because there isn't much room left on a System 6.0 startup disk, the Install 
program replaces several system files with compressed versions of the files. 

Note 

If you install HardPressed on a 3.5-inch system disk, do so only on a backup copy. 

You can either make a copy of the System. Disk included in the System 6.0 package, or use 
the System Installer to create a minimum system disk. This HardPressed Installer option 
works with System 6.0 system disks only and will not work with a System 6.0.1 system 
disk. If you use this Installer option and have only one 3.5-inch disk drive, many disk swaps 
will be necessary. 



6 Select which installation to perform by clicking it in the list. 

7 Click Install to install HardPressed. 

When the Install program is finished, it may display a message "An update has altered 
system files on the startup disk. You can no longer use desk accessories." 

If the installation was successful, HardPressed is now installed on your startup disk. If 
the installation fails (you receive an error message), restart your computer with the 
Shift key held down to disable extensions, then try the installation again. If the 
installation still fails, contact WestCode Software for assistance. 

8 After you successfully install HardPressed, click Quit. 
The Install program asks you to restart your computer. 

9 Click Restart System to continue. 

HardPressed loads automatically when your IlGS starts up. 
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Welcome to the lies 




System 6.0 








The HardPressed icon appears at the bottom of the startup screen, verifying that 
HardPressed is loaded and ready to use. 




If you ever want to prevent HardPressed from loading, press and hold down the H key 
during startup. 
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Where the Installer Puts Files 



If you're interested in what the Installer is doing, it's copying the HardPressed software 
into various folders within the System folder on your startup disk. The following table 
summarizes which files are placed in each folder, with a brief description of each file. 



File 


Folder 


What it's for 


HardPressed 


System.Setup 


The HardPressed INIT performs the actual 
compression and expansion of files. 


HP.Modules 


System.Setup 


This folder contains the profiles and individual 
compression modules that HardPressed uses. 


HP.Prefe 


System.Setup 


This file contains settings for HardPressed that you 
can change in the HardPressed control panel. 


HardPressed.CDV 


CDevs 


The HardPressed control panel allows you to mark 
folders for compression and set other options. 


HardPressed.CDA 


DesLAccs 


The HardPressed Control desk accessory lets you 
turn HardPressed on or off from any application. 


HardPressed.FXT 


FinderExtras 


The HardPressed Finder extension allows you to 
compress and expand files you select in the Finder. 


HardPressed.ICN 


Icons 


This file contains Finder icons for the various files 
that HardPressed creates and uses. 



You should now read the next chapter. Using HardPressed, for a tutorial that shows you 
how to use the main features of HardPressed. 
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This chapter shows you how to use the main 
features of HardPressed. In this chapter, you'll 
learn how to mark folders for automatic 
compression, then watch as HardPressed 
compresses a file you save in a marked folder 
You'll also learn how to compress and expand 
files using two new commands in the Finder 
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About the Practice Folder 

To give you some hands-on experience with HardPressed, we have included a folder 
called Practice on the HardPressed disk. This folder contains three files: a GS/OS 
application called Teach, a Teach document containing text, and an Apple Preferred 
graphic file. Compressing these different types of files will give you a good idea of the 
kind of results you can expect with HardPressed. 

This tutorial will show you how to do the following: 

■ mark folders for automatic compression 

■ compress a file by saving it in a marked folder 

■ compress and expand files in the Finder 

■ check compression statistics on compressed files 

Before you begin, please make a backup copy of your original HardPressed disk. (Use 
the Finder to make the copy.) Use your backup copy throughout the tutorial. 

The tutorial assumes that you're working with the Practice folder on your backup disk. 
For faster performance, however, you can copy the Practice folder to your hard disk (if 
you have one) and do the tutorial from there if you want. 

Automatic Compression 

This section shows you how to use the HardPressed control panel to mark which 
folders you want compressed automatically. When you create or save fiiles in a marked 
folder, HardPressed automatically compresses the fiiles. 
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You can mark any number of folders on your disks, and you can mark folders on just 
about any kind of disk, including ProDOS, AppleShare, and HFS disks. 

1 Make sure your backup copy of the HardPressed disk is not write-protected. Remove 
your original HardPressed disk from the disk drive and insert your backup copy. 

2 Pull down the Apple menu and choose Control Panels, then click the scroll arrow to 
move down to the HardPressed icon. (You can press H to quickly scroll to the 
HardPressed icon.) 



iD^= Control Panel; i 



Dbout the Finder... 
Help (5? 



Calculato r 
liflUffillJI 

Find File 















DC Printer 




IIMiMl 




General 





(LJeenJ 
t Help ] 



2.D 



iD^= Control Panel; i 



General 



HardPressed'i^ 



Keyboard 



(LJeenJ 
t Help ] 



2.D 



3 Double-click the HardPressed icon to open it. 



i 


~l HardPressed'" ^^^^= 




ul.D Copyright 1993 flndy HcFodden 
UestCcde Software, Inc. 




l— HardPressed Status , 






® Compress and Expond 
O Expand only 
O Inoctiue 






'rofile:! Standard | 






[Preferences...] ^ Folders... J 




This copy of HardPressed'^ belongs to; 
Jeff Jungblut 
UestCode Software 



The HardPressed control panel window appears. 
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Marking Folders in the HardPressed Control Panel 

Now you'll mark a folder on the HardPressed disk. 
1 Click the Folders button. 



I Hark Folders I I:! 



■II :HordDisk.l 



CH DppleUorks.GS 

Q I1W3 

C2 BeogleUrite.GS 

CD Games 

C2 Icons 

C2 Platinum. Paint 

C2 Shrinkit.GS 

CD Soundsmith 

CD System 

CD TrueTape. Fonts 

[^Hark [a] Open 

[Z7|UnHark [5] Close 



A list of folders on the current disk appears. Only folders are shown, not files. At the 
top of the dialog box is a pop-up menu listing all of the disks you have online. 

2 If the HardPressed disk isn't shown, choose HardPressed from the pop-up menu. 



1 Hark Folders 1 :HardPressed h 


O :HardPressed 




CD Goodies 
CD Icons 
CD Install.Files 
CD Practice 
CD System. Files 


Hark [s] Open ( Sfvert ) 
rTlUnHork fol Close ^ Done } 



A list of folders on the HardPressed disk appears. 
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3 Click the Practice folder to select it, then click the Open button. 



Hark Folders 1 :HardPrfsssd h 


<S> :HardPre;sed 
CH Goodies 
CH loons 
C2 Instoll.Files 




tS Proctice 
CD Hork.He 


C2 System. Files 


Mork |Ta| Open ( Sfvert ) 
rTlUnHork fol Close ^ Done } 



The Mark.Me folder appears underneath the Practice folder. Both the Practice and 
Mark.Me folders are selected. 

4 Click the Mark.Me folder so that only Mark.Me is selected. 

5 Click the Mark button. 



Hark Folders 1 :HardPressed h 


<S> :HardPressed 
C2 Goodies 
C2 loons 
C2 Install.Files 
^ Practice 








C2 System. Files 


[^Hork [sjOpen ( Rei/ert ] 
rTlUnHark fol Close ^ Done } 



A checkmark appears next to the Mark.Me folder, indicating the folder is marked. 
6 Click the Done button to accept the change. 
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From now on, HardPressed will compress any files you save in (or copy to) the Mark.Me 
folder. 

7 Click the close box in the HardPressed window to close it, then close the Control 
Panels window. 

Saving Files in Marl<ed Folders 

Now you'll use the Teach application to open a file, make a change to it, then save it in 
the Mark.Me folder. HardPressed will compress the new copy of the file. 

1 From the Finder, open the Practice folder, then double-click the Teach icon in the 
Practice folder. 

In a few moments, the Teach menu bar and an untided window appear 

2 Close the untided window, then choose Open from the File menu. 



Pl9as9 select file to open. 
Sl^Proctice (ProDOS) 


( Volumes J 




□ Trek.List ^ 




(f Open D 
( Close ] 
( Cancel ) 







The Open dialog box appears, listing the Mark.Me folder and one document, Trek.List. 
3 Click Trek.List to select it, then click Open. 
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•t File Edit Font Style 


Size 




□ 


Trek.List 




Star Trek TOS List of Lists 
compiled by Hark Holtz 


I 





(Revised Jonuory 2. 1QQ2) 



DISCLniMER: "Stor Trek", "Enterprise", ondoll other reloted items ore 
copyright and trademarks of Paramount Communications. Any infringement o 
these lists on Paramount's legitimate copyright and trademarks are purel 
unintentional, andwill be corrected upon proper notification. 



Table of Contents 



Star Trek (The Original Series) 
Cost Listings 
Episode Listings 
The Best of Trek 
Syndication Kotes 
fllternotiue Japanese Titles 
Trek In Other Lands 
"I'm Doctor, not o 



The document appears in a new window. 

Make a change to the document. (Try adding a blank Une to the beginning, or change 
the font or color.) 

Choose Save Copy as from the File menu. 



Q^Practice (ProOOS) 
Mfreeofl633NK. ( -| 



[ Open 
f Close 1 



ii I(>(n;!i 
i;:5 li'tk.l.ist 



Soue the file os: 



[ Cancel 



Save in which format? 

®Teach OText Oinstaller 



The Save dialog box appears. 

Click the Mark.Me folder to select it, then click Open. 
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7 Click in the file name box. Type a new name for the document, such as New.List, then 
click Save. 



aSHork.Me (ProDOS) 



^ [ Kew Folder J 



_| f Close ) 

■0 



Save the file gs: ^ Save^ ^^ 



Neit.Listl 



[ Cancel "j 



Save in which format? 

®Teach OText Olnstaller 



MOD 



Teach saves the new file in the Mark.Me folder, then HardPressed compresses the new 
file. The "emptying document" cursor appears briefly while HardPressed is working. 

8 After you save the file, choose Quit from the File menu to return to the Finder 

Compare the size of the original Trek.List file and the New.List file you just created. The 
original, uncompressed copy is 33K in size, while the new, compressed copy is only 
19K. 
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Opening Compressed Documents 

Your GS/OS applications can open compressed files just as they would open normal, 
uncompressed files— you don't need to expand them first. To try this out, continue with 
the following steps. 

Double-click the New.Iist icon in the Mark.Me folder. 

Teach opens the New.List document. The "filling document" cursor appears briefly 
while HardPressed expands the file. 

Without making any changes to the document, choose Quit from the File menu to 
return to the Finder. 

Notice that the size of the New.List document is still only 19K. When you opened the 
New.List document, HardPressed expanded the file into its file cache, a place in 
memory used to store files that HardPressed is working on. Teach then read the file's 
data from the fide cache, while the original file remained compressed on the disk. 

Moving and Copying Files to Marked Folders 

You've learned that when a file is created or saved in a marked folder, it gets 
compressed. What happens if you use the Finder to move an uncompressed file to a 
marked folder? 

1 Open the Mark,Me folder if it isn't already open. 

2 Drag the USA.Map icon from the Practice window to the Mark.Me window. Notice what 
happens. 



1 
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Practice 

ProDOS l!|t.eji.s. .^.-.l^l'/M .^.■5.M.t.':?? 
Home Size Kind La 



Teach i(6K GS/OS application 

13 Trek.List 33K Teach document 



■III Hark.He 
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E3 New.Liit 19K Teach document 
1 




^1 lo 





That's right— HardPressed does not compress the file. Why? Because the Finder is only 
moving the file instead of copying it. When the Finder moves a file from one folder to 
another on the same disk, it does not need to open, read, and write the file's contents- 
it just updates the two folders to show which folder contains the file you've moved. 
Because no new or changed file is created, no compression is done. 

If you copy a file from another disk into the Mark.Me folder, the Finder would need to 
open, read, and write the file's contents to create the copy. In this case, HardPressed 
would then compress the new copy of the file. To see how this works, continue with 
the following step. If you have only one disk drive (the drive containing your 
HardPressed practice disk), skip ahead to the Manual Compression section. 

3 Try dragging a file from the Practice folder to another disk, such as your RAM disk, then 
drag it from the other disk into the Mark.Me window. 

After you drag the file to the Mark.Me folder, the filling document cursor appears while 
HardPressed compresses the fiile. 
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Manual Compression 

This section describes how to compress and expand files you select in the Finder, using 
new commands in the Finder's Extras menu. You can use these commands to compress 
and expand files at any time— even in unmarked folders, or when the HardPressed 
control panel is set to Inactive. 

Compressing and Expanding Files in the Finder 

You'll begin by compressing all of the files in the Practice folder. 

1 In the HardPressed disk window, click the Practice folder to select it. 

2 Choose Compress from the Finder's Extras menu. 




Compression Info 611 

Crsiitih SihUfihf fliids.. 



HardPressed compresses all files in the Practice folder A dialog box indicates the 
progress of the compression. 



Items remaining to be compressed: | 2 1 

Now processing: USfl.Mop 

^^^^M I I Stop 1 



3 Open the Practice folder if it isn't already open. 
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Notice that the file sizes are smaller than they were before. The table below shows what 
the file sizes should look like before and after compressing the folder and the 
approximate savings. 



File Name 


Size Before 


Size After 


Savings 


Compression 


Teach 


47.8K 


40.6K 


7.2K 


15% 


Trek.List 


31.4K 


17.9K 


13.6K 


43% 


USA.Map 


13.4K 


6.9K 


6.4K 


47% 



You will get different rates of compression for different kinds of files depending on the 
data in each file. The table shows that while the the Teach application is about 15% 
smaller, the USA.Map file is about 47% smaller and the New.List file is about 43% 
smaller. Generally, you will find that graphic files and files containing text can be 
compressed smaller than other types of files. 

Checking Compression Information 

This section shows you how to get compression information about one or more files 
using the Compression Info command in the Finder. 

1 Click the USA.Map icon to select it, then choose Compression Info from the Extras 
menu. 



=n Compresiiiin 
Totiil number of file;: 


1 


Compresied file;: 


1 


Originol size: 
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Compressed size: 


iM 


flueroge campression: 


m 


Savings: 




Data fork: 




Standard LZU 
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A window appears, showing the original and compressed size of the file. The window 
also shows how much space was saved by compressing the file and the compression 
module used. 

2 Click the window's close box to close the window. 

3 Click the Practice folder in the HardPressed disk window to select it, then choose 
Compression Info from the Extras menu. 



=n CompressiDn 
TDtol number of files: 


5 


Compressed files: 




Original size: 


m.lK 


Compressed size: 


83.3K 


flueroge compression: 


32t 


Savings: 


40.SK 



When you select more than one file and choose Compression Info, the window shows 
the compression statistics for all of the selected files. It shows the total number of files 
selected, the number of compressed files in the selection, the original and compressed 
size of the compressed files, the average compression of all the compressed files, and 
the total amount of space saved by compressing. The window does not show the 
compression module used when you select multiple files because different files may 
have been compressed with different modules. 

4 Click the window's close box to close the window. 



Where to Go Next 

Congratulations! You have learned how to use the primary features of HardPressed. 
The next two chapters go into detail about the features you learned about in this 
chapter 
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■ Chapter 4, The HardPressed Control Panel, explains in greater detail how to mark 
and unmark folders. It also shows you how to use other options in the 
HardPressed control panel. 

■ Chapter 5, The HardPressed Finder Extension, provides a reference to the 
commands in the Finder's Extras menu. 
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This chapter describes the options in the 
HardPressed control panel device. It shows you 
how to mark and unmark folders, choose a 
compression profile, choose a folder to hold 
temporary files, change the size of the file cache, 
and set other options. 
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Using the HardPressed Control Panel 

The settings you choose in the HardPressed control panel determine how HardPressed 
compresses and expands files. With the control panel you can select which folders are 
automatically compressed, where temporary files are stored, and how much memory 
HardPressed uses for its built-in file cache. 

You access control panels by choosing Control Panels from the Apple menu. In the 
scroll box at the left of the control panel window are various icons representing each 
control panel device. 



About the Finder... 
Help (i? 

Calculator 



ii 

Find File 



; Control Panels 1 




To open the HardPressed control panel, click the scroll arrow to move down the list 
until you see the HardPressed icon. (You can also select the icon by typing the first few 
letters of its name.) To open the icon, click it once to select it and then click Open, or 
double-click the icon. The HardPressed window appears. 
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IHardPressed" 



ul.0 Copyright 1993 flndy HcFadden 
UestCode Software, Inc. 



,— HardPressed Status — 
® Compress and Expand 
O Expand only 
O Inoctiwe 



Profile: | Standard j 



[Preferences... ] ^ Folders... ^ 



This copy of HardPressed'" belongs to: 
Jeff Jungblut 
UestCode Software 



To choose an option, use the mouse or type the option's keyboard equivalent: 

-C Compress and Expand 

-E Expand only 

-I Inactive 

-S Standard profile 

-P Preferences 

-F Folders 



Each feature is explained in the following sections. 



Changing HardPressed Status 

The three options in the HardPressed Status box let you control how HardPressed 
operates. You can have HardPressed automatically compress and expand files as you 
save and open documents; automatically expand files, but not compress; and leave files 
as they are. 
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Compressing and Expanding Files Automatically 

If you select Compress and Expand, HardPressed compresses and expands files 
automatically as you open and save documents and applications. This is the setting 
you're likely to use most often. 

When you open an application or document that's been compressed, HardPressed 
expands the file into its file cache or temporary folder. The application that opened the 
document then reads the file's contents fi-om the expanded copy. When you close the 
document, HardPressed deletes the expanded file, leaving only the original, 
compressed file. 

When you save a document into a folder that you have marked for compression, 
HardPressed first compresses the saved file into its file cache or temporary folder, then 
replaces the original file with the compressed copy. 

Expanding Automatically, but not Compressing 

When you select Expand only, HardPressed expands any compressed files that you 
open or copy. No compression is done when you save a file in a folder you have 
marked for compression; fiiles are always saved uncompressed. 

Use this option when you want to work with a compressed file, but you don't want to 
waft for the file to be re-compressed each time you save ft. 

While no automatic compression occurs when this option is selected, you can still 
compress files manually using the Compress command in the Finder's Extras menu. 
For information about the HardPressed commands in the Extras menu, see The 
HardPressed Finder Extension on page 53. 
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Turning Off Automatic Compression and Expansion 

When Inactive is selected, HardPressed does not automatically compress or expand 
files. Select this option when you want to copy compressed files in the Finder. This 
makes copying considerably faster, because you won't have to wait for HardPressed to 
expand the file, let the Finder copy it, then compress the new copy. 

When HardPressed is inactive, compressed files appear as "archival library" files in the 
Finder instead of their regular type. 
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Home 


Size 


Kind 




□ Box.Effects 


m 


Drchival library 
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□ Patterns 
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□ Pierre 
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□ Radar 
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□ Read.Me.First 
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□ Rebecca 
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JTr 












You cannot open compressed files when HardPressed is inactive. 

Because compressed files appear as archival libarary files when HardPressed is inactive, 
your applications will not list compressed files in the standard Open File dialog box. Before 
accessing a compressed file, you must make HardPressed active. 



To make HardPressed active, you can select the Compress and Expand or Expand 
only option in the control panel. You can also change the status of HardPressed using 
the HardPressed Control desk accessory in the Classic Desk Accessory menu. For 
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information about this desk accessory, see The HardPressed Control Desk Accessory on 
page 59. 

When HardPressed is inactive, you can still compress and expand files manually using 
the Compress and Expand commands in the Finder's Extras menu. For information 
about the HardPressed commands in the Extras menu, see The HardPressed Finder 
Extension on page 53. 

Note 

Finder windows are not updated when you change the active status. 

If you have a Finder window open tliat contains compressed files, and you change the 
active status of HardPressed, the Finder won't update the display of file types until you 
close and re-open the window. 



Choosing a Compression Profile 

To specify how you want HardPressed to compress files, you can choose one of several 
compression profiles. Choosing a profile allows you to select greater compression with 
a loss of speed, or greater speed with less compression. The Standard profile setting is 
best for most uses and you probably won't need to change it. 



Standard ciS 



Faster, less compression 
Slower, more compression 



nil 


RLE 


nil 


LZIO 


nil 


Faster LZW 


nil 


RLE+LZU 


nil 


LZSS 



Standard ^ProDDS 8 
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Each profile contains a list of file types that can be compressed and which compression 
module to use for each type of file. For example, the Standard profile uses the RLE 
compression module for GS/OS applications, the LZW module for Apple Preferred 
Format graphic files, and no compression for ProDOS 8 files. You don't really need to 
know which modules are used, but if you're curious, see the tables beginning on 
page 79. 

The Standard, Faster, Slower, and Standard + ProDOS 8 profiles compress files using 
a different compression module for each kind of file. The profiles beginning with All 
compress all files (including ProDOS 8 files) using the same compression module. 

All files that you compress (either automatically or manually) are compressed using the 
active profile, regardless of how they may have been previously compressed. For 
example, if the active profile is All: Faster LZW, and you open a document that was 
compressed using LZSS, the file will be compressed using Faster LZW (instead of LZSS) 
when you save it. 



^Warning 

HardPressed cannot expand files under ProDOS 8. 

If you compress files using an All profile or the Standard+ProDOS 8 profile, the files 
won't be accessible to ProDOS 8 applications. While using one of these profiles is a good 
way to archive your seldom-used files, it also means you will have to expand the files 
manually (using the Finder extension) before you can work with the files in a ProDOS 8 
application. (This is why the Standard, Faster, and Slower profiles do not compress 
ProDOS 8 files.) In addition, files you save under ProDOS 8 are not automatically 
compressed. 



Strategy for Choosing a Profile 

The profile you choose is mostly a matter of personal preference; each has its 
advantages and disadvantages. The following is our recommended strategy for 
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compressing your files to get the maximum amount of fi-ee disk space, with the 
minimum amount of time spent expanding and re-compressing files as you use them: 

1 Open the HardPressed control panel. 

2 Choose All: LZSS from the Profile pop-up menu. 

The LZSS compression module compresses slowly, but it generally provides better 
compression than the other modules. In addition, files compressed with LZSS expand 
very rapidly, so it's an excellent profile for compressing GS/OS applications and other 
files that don't change. 

3 In the Finder, select the files, applications, folders, or disks you want to compress*. 
Because LZSS compresses files slowly, the compression will take some time. To start 
with, select just a few small- to medium-sized files. 

4 Choose Compress from the Extras menu. 

HardPressed compresses the selected files with the LZSS compression module. You'll 
end up with a set of highly compressed files. 

5 Choose Standard or Faster from the Profile pop-up menu. 

These profiles are better for day-to-day use because they compress fiiles faster than 
LZSS. Remember, fiiles compressed with one profile can still be expanded when another 
profiile is active. 

6 Close the HardPressed and Control Panel windows. 



*For a list of which files in the System folder you can safely compress, see Compressing System Files on page 63. 
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When you close the HardPressed control panel, the settings are saved in the HP.Prefs 
file in your System. Setup folder. HardPressed uses these settings each time your 
computer starts up. 

Marking Disks and Folders for Automatic Compression 

If you want to have files compressed automatically when you save them, you must first 
tell HardPressed which folders you want compressed. You do this by marking folders 
on each disk. When you save a file in a marked folder, HardPressed compresses the file. 
When you save a file in an unmarked folder, no compression is done. 

To mark folders for compression, click the Folders button in the HardPressed control 
panel. 



1 Hark Folders 11 :HardDisk.l i 


1 il iHordDisk.l 


<} 


CD flpplel^orks.GS 
CD flW3 

CD BeagleUrite.GS 
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m 
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f^Mork |TS|Open [ Reuert ) 
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The Folders dialog box appears. 
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Choosing a Disk 

The pop-up menu at the top of the dialog box lists all disks you have online. To switch 
disks, choose a different disk from the pop-up menu. The list box shows all the folders 
on the disk you choose. 



(S) :flngus 
^:Graphics 

tSB :RflH5 
QD :Startup.Disk 



You can mark any kind of disk or folder that GS/OS can write to, such as ProDOS, HFS, 
and AppleShare. This includes 3.5-inch disks, 5.25-inch disks, hard disks, RAM disks, 
and file server volumes. You cannot mark DOS 3.3 or Pascal disks because GS/OS 
cannot write to these kinds of disks. 

i\/larl<ing and Unmarl<ing Folders 

To mark a folder for compression, first select the folder name in the list using the 
mouse or the arrow keys. To select all the folders, press -A. You can select a group of 
folders by holding down the key and clicking each folder you want to select. 

To mark the selected folders, click the Mark button or press -M. When you save a file 
in a marked folder, or in any folder within a marked folder, HardPressed compresses it 
automatically. Files you copy (but not move) into a marked folder are also compressed. 

By allowing you to mark folders, HardPressed lets you decide which folders you want 
compressed automatically and which folders you'd rather not have compressed. 
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Shrinkit.GS 
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System 
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I ^1^1 Hork |TS| Open [ Reuert ] 
PlUnHork [o] Close g Done | 



To remove a mark from a folder, select the folder, then click UnMark (or press -U). 
HardPressed won't compress files you save in (or copy to) an unmarked folder. 




Marking and unmarking doesn't automatically compress or expand files. 

HardPressed compresses files automatically only when you save a file in (or copy a file to) 
a marked folder. Simply marking a folder won't cause HardPressed to immediately 
compress all the files in the folder. Likewise, unmarking a folder doesn't cause 
HardPressed to expand the folder's contents. 



Marking the Main Folder 

The item at the top of the list (HardDisk.1 in the earlier example) represents the main 
folder (sometimes called the root directory) of the disk. Files in this folder are the files 
that are shown in the Finder when you open a disk's icon. When the disk's main folder 
is marked, files will be compressed when you save them in the main folder; however, 
files in other folders on the disk are compressed based on each folder's marked or 
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unmarked setting. (Marking the main folder doesn't mean the entire disk is marked, 
only the main folder is marked.) 

Opening Folders 

We mentioned earilier that when a folder is marked, all folders within it are also 
considered marked. There are situations in which you may want some folders within a 
marked folder to be unmarked, and HardPressed provides that option. To mark and 
unmark folders within another folder, select a folder and click Open, press -0, or 
double-click the folder name. HardPressed lists all folders within the selected folder 
and selects them for you. 



Mark Folders H iHardDisk.! 



Hi :HardDisk.l 



^ flppleWorks.GS 
CD Current.Work 
CD Illustrations 

^ CD Newsletters 



^ m BeoglelOrite.GS 

iD Games 

Hi Icons 

■y CHS Plotinum.Paint 

^ m Shrinkit.GS 



1^1 Hark [^]Open [ Reuert ] 
rTIUnHork [E] Close Done | 



You can now select, mark, and unmark folders within the opened folder. If any of the 
folders shown contain more folders, you can open them too. 

In the example above, we have marked the open AppleWorks.GS folder and two 
folders within it. Illustrations and Newsletters. We've left the Current.Work folder 
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unmarked because we frequently open and save files in this folder, and we don't want 
HardPressed to compress a file each time we save it. 

Closing Folders 

To close an open folder, click the folder's name in the list, then click Close. 



In the list of marked and unmarked folders, what you see is what you get. 

Remember that when a closed folder is marked, all folders within it are considered 
marked. In the previous example, if we closed the AppleWorks.GS folder, which is 
marked, then the unmarked Current.Work folder would again be considered marked. 



Restoring the Original Folder Settings 

To restore the folder marks to the way they were when you opened the dialog box, click 
the Revert button. HardPressed re-reads the folder settings from the disk and displays 
the previous settings. 

Saving the New Folder Settings 

To save the folder marks for the chosen disk, either choose another disk from the pop- 
up menu or click Done. HardPressed saves the folder marks in an invisible file called 
HP.Vol.Prefs in the main folder of the disk. 




Note 



Folder marks on RAM disks are lost when you turn off your computer. 
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Creating New Folders 

New folders you create inherit the marked status of their parent folder. For example, if 
you create a new folder within a marked folder, the new folder will also be marked (it 
doesn't matter if the parent folder is open or closed in the list). The same is true when 
you copy a folder: if the parent folder containing the new copy is marked, then the new 
copy will also be marked; otherwise, it will be unmarked. 

Any new folders you create in the main folder of a disk will be marked if the main folder 
of the disk is also marked. 

Setting Preferences 

The Preferences dialog box contains options you can set for the file cache, the 
temporary folder, file verification, Finder key equivalents, and other items. 

To open the Preferences dialog box, click Preferences in the HardPressed control 
panel. The Preferences dialog box appears. 





HardPressed™ Preferences 
— General 






File Caching: 256K k 

1 1 Uerif a after compression 

^ Show progress with cursor 

— Finder Extension 






EH Handle locked files 
Compress files: (i- [3~| 
Expand files: li- [u~| 
Compression info: (i- [F^ 

(Temp... )[ Cancel]^ OK 
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Choosing a Size for the File Cache 

The file cache is an area of memory set aside to hold files while HardPressed works on 
them. For example, when you open a compressed file while working in an application, 
HardPressed temporarily stores the expanded copy of the file in its file cache if there is 
enough room. If there isn't enough room in the cache for the expanded copy, 
HardPressed creates a temporary file on a disk. (See Selecting a Folder for Temporary 
Files on page 48.) 

The cache size is preset to 256K. You can change the size of the cache from 32K up to 
1024k. To change the cache size, choose a new size from the File Caching pop-up 
menu. To turn the cache ofi^ choose Off fi-om the pop-up menu. If you turn the cache 
off, HardPressed will always use temporary files instead of memory when compressing 
and expanding fiiles. 

Using a larger cache size increases the speed of HardPressed, because a larger cache lets 
HardPressed compress and expand more (and larger) fiiles in memory instead of in 
temporary files on a disk. Also, the more memory you allocate to the file cache, the less 
disk space you'll need for temporary fiiles. 

The size you choose for the file cache is a maximum limit. If you set the file cache to 
512K, HardPressed does not permanently take away 512K fi-om the system; it will use 
up to 512K for caching the fiiles it's working on. 

About the Temporary File Folder 

Vflien HardPressed runs out of room for temporary files in its file cache, it stores them 
on a disk. By default, HardPressed stores its temporary files in a folder named 
TempFiles on your startup disk, but you can change the location if you want. 

If you want HardPressed to store its temporary fiOies in the same folder as the fiile it's 
working on, deselect the Use a single temporary file folder checkbox. However, if 
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you compress files on slower disks (such as 5.25-inch or 3.5-inch disks), we 
recommend that you select a single folder on a faster disk (such as a large RAM disk or 
a hard disk) for holding temporary files. 

Selecting a Folder for Temporary Files 

To change the location of the temporary folder, click the Temp button or press -T. 
The Set Temporary File Folder dialog box appears. 



Set Temporary File Folder 
^ Use a single temporary file folder 
Folder for temp files: [Select...] 



:TeinpFiles:| 



[ Cancel ] i( OK | 



An easy way to select a folder for temporary files is to use the Select button. When you 
click Select, another dialog box appears. 





Put temporary files where? 
S^TempFiles (ProDOS ( ii^Ti; \ 

llSfrPPnf ^ ''-^ > 








I Hew Folder J 




t Close ) 




^ Accept ]p 




( Cancel ) 
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1 To select a different disk than the one shown in the pop-up menu, click Disk. Choose a 
disk by selecting the disk's name and clicking Open, or by double-clicking the name. 

2 Use the Open and Close buttons to move to the folder you want HardPressed to use for 
temporary files. 

3 If you want to create a new folder on the selected disk, click New Folder. 

4 When the folder you want appears in the pop-up menu at the top of the dialog box, 
click Accept. 

The GS/OS pathname of the folder you selected appears in the input box. 




Here are two suggestions for choosing where temporary files should be stored: 

(1) Choose a folder on a fast disk. A folder on a hard disk using a RamFAST controller (if 
you have one) or a folder on a large RAM disk are ideal. For working with temporary files, 
our tests show that using a hard disk with a RamFAST controller is actually faster than 
using a RAM disk. 

(2) Choose a folder on a disk that has plenty of free space— enough space to hold a file 
that is 1 .5 times as large as the expanded size of your largest compressed file. For 
example, if your largest compressed file is one megabyte when expanded, choose a folder 
on a disk that has at least 1 .5 megabytes free. 



You can also select a new folder for temporary files by typing a complete GS/OS 
pathname in the input box. The default pathname shown is *:TempFiles, which (to 
GS/OS at least) means the TempFiles folder on the startup disk. 

Pathnames must begin with a colon (:), followed by the disk name, and end with a 
colon. Any folder names included in the pathname must also include a colon. An 
example would be :RAM5:TempFiles:, which means the folder named TempFiles on 
the disk named RAM5. 
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Warning 

If you type a pathname, be sure it's correct. HardPressed won't check it. 

If you type an incorrect pathname (such as a pathname for a folder that doesn't exist), 
HardPressed won't tell you right away. However, you will receive a series of error 
messages when HardPressed is later unable to create a temporary file. In general, it's best 
to use the Select button to choose a pathname. 



Verifying Files After Compression 

Our first reaction to a verify option was that if we thought it was necessary, we wouldn't 
sell the program. However, some people may not have the same faith in data 
compression as we do*, so we provide a way to verify that the compressed copy is good 
before removing the uncompressed copy. 

To turn on file verification, select the Verify after compression checkbox. When 
verification is turned on, HardPressed goes through an extra step after it finishes 
compressing a file: it expands the file again, verifying that the data that it expands 
matches the data in the original file exactly. 

The comparison is done by computing a CRC (Cyclic Redundancy Check) before 
compression and after expansion. When verifying, the file is expanded in memory but 
not stored on disk. This makes the verification pass fairly fast, but compressing a file 
with verification turned on can still take up to twice as long as it would to compress the 
file without verification. 

You can also turn the verification option on or off using the HardPressed Control desk 
accessory. See The HardPressed Control Desk Accessory on page 59. 




* There are also some people who still believe the Earth is flat. There may or may not be any correlation between the two groups. 
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Showing Progress in the Mouse Cursor 

When HardPressed is working on a file, it shows its progress by changing the mouse 
cursor to a document icon that empties (while compressing a file) or fills up (while 
expanding). To turn this feature off, deselect the Show progress with cursor 
checkbox. When the feature is turned of^ the standard watch cursor appears whenever 
HardPressed expands or compresses a file. 

Choosing How to Handle Locl<ed Files 

When you use the Finder extension to expand a locked fiile, HardPressed will expand 
the locked file, unlock the original file, replace it with the expanded file, then lock the 
new, expanded file. If you don't want HardPressed to change locked files at all, deselect 
the Handle locked files checkbox. When this option is turned off, you must manually 
unlock a locked file before you can expand it. (You can use the Icon Info command in 
the Finder's Special menu to lock and unlock files.) Also, HardPressed won't 
automatically compress a locked fiile if this option is turned off. 

For more information about the commands in the Finder's Extras menu, see The 
HardPressed Finder Extension on page 53. 

Changing Key Equivalents for the Finder Extension 

Each HardPressed command in the Finder's Extras menu has a keyboard equivalent. 
You can change the key used for each command by typing different letters in the boxes. 
The defauh key equivalents are: 

-P Compress files (P for Pack) 

-U Expand files (U for Unpack) 

-H Compression info (H for HardPressed Info) 
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For more information about the commands in the Finder's Extras menu, see The 
HardPressed Finder Extension on page 53. 

Saving Changes to Preferences 

To accept your changes and close the Preferences dialog box, click OK. To throw away 
your changes and close the dialog box, click Cancel. 

The settings in the Preferences dialog box are stored in the HP.Prefs file, which you can 
find in the System.Setup folder inside your System folder. 
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About the HardPressed Finder Extension 



The HardPressed Finder extension is a small piece of software that allows you to access 
the compression and expansion features of HardPressed from within the Finder. The 
Finder extension installs three new commands in the Finder's Extras menu: Compress, 
Expand, and Compression Info. Each command is described in the following 
sections. 




Compression Info 6H 



Crihiitf Stfififf StKis, 



The Compress command in the Extras menu allows you to manually compress any 
selected files, folders, or disks. The compression method used depends on the active 
profile chosen in the HardPressed control panel. 

To compress one or more files: 



Compressing Files, Folders, and Disks 



1 



Select the icon(s) of one or more files, folders, or disks. 



2 



choose Compress from the Extras menu. 



A dialog box indicates the progress of the compression. 



Items remaining to be compressed: 



37 



How processing: Plotinum.Point 



] [ Stop 3 
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Warning 



If you want to compress files in the System folder, read Appendix A first. 

Certain files in the System folder should not be compressed because they need to load 
before HardPressed loads when your system starts up. If GS/OS cannot load a file 
because it's been compressed, unpredictable results may occur. For a list of which files in 
the System folder are safe to compress and which are not, refer to Appendix A— 
Compressing System Files on page 63. 



Expanding Files, Folders, and Disks 

If you compress files that you plan to use with ProDOS 8 applications, or you want to 
give a copy of a compressed file to someone who doesn't own HardPressed, you'll need 
to first expand the file using the Expand command. 

The Expand command in the Extras menu works like the opposite of the Compress 
command: it allows you to manually expand any compressed files, folders, or disks. 
The files you select for expansion can be expanded no matter what profile is active in 
the HardPressed control panel. 

To expand one or more compressed files: 

1 Select the icon(s) of one or more files, folders, or disks. 

2 Choose Expand from the Extras menu. 

A dialog box indicates the progress of the expansion. 



''■Actually, the results are fairly predictable. The computer will most likely crash. 
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Items remaining to be expanded: | 2H 

How processing: Plotinum.Point 



D [ Stop 3 



Checking Compression Information 

The Compression Info command displays a window containing compression statistics 
about the selected file or files. To use the Compression Info command: 

1 Select the icon(s) of one or more files, folders, or disks. 

2 Choose Compression Info from the Extras menu. 



A window appears, showing the original and compressed size of the file. The window 
also shows how much space was saved by compressing the file and the compression 
module used for both the data fork and resource fork of the file. 



=n ! Compression 

Total number of files: 


1 


Compressed files: 


1 


Original size: 


32.0K 


Compressed size: 


12.2K 


Average compression: 


m 


Savings: 


IQ.SK 


Data fork: 




Standard LZU 





Total number of files: 


1 


Compressed files: 


1 


Original size: 


208.8K 


Compressed size: 


185.0K 


Average compression: 


m 


Savings: 


23.8K 


Oata fork: 




RLE 




Resource fork: 




RLE 





If you select more than one file and choose Compression Info, the window shows the 
compression statistics for all of the selected files. It shows the total number of files 
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selected, the number of compressed files in the selection, the original and compressed 
size of the compressed files, the average compression of all the compressed files, and 
the total amount of space saved by compressing. The window does not show the 
compression module used when you select multiple files because different files may 
have been compressed with different modules. 



Total number of files: 


987 


Compressed files: 


651 


Original size: 


7.7MB 


Compressed size: 


4.7MB 


fluerage compression: 


m 


Savings: 


2.m 



3 Click the window's close box to close the window. 
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This chapter describes the options in the 
HardPressed Control desk accessory. Available 
in the Classic Desk Accessories menu, 
HardPressed Control allows you to turn 
HardPressed on or off from within any GS/OS 
application. 
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About the HardPressed Control Desk Accessory 

HardPressed Control is a classic desk accessory (CDA) that you can access through the 
text-based Desk Accessories menu. It contains an option that lets you control the status 
of HardPressed and a file verification option, each of which is also available in the 
HardPressed control panel. 

These options are available to you when you are running any GS/OS application, 
including text-based applications such as a communications program or a development 
environment. You can change the options in this desk accessory instead of returning to 
the Finder and making the changes through the HardPressed control panel. 

This desk accessory isn't available when you are in a ProDOS 8 application. 
When to Use the Desk Accessory 

Use the HardPressed Control desk accessory when you want to make HardPressed 
inactive only temporarily— for example, before copying a batch of compressed files in 
the Finder. After copying the files, you can quickly make HardPressed active again by 
opening the desk accessory and changing the status back to Compress and Expand or 
Expand only. 

After a bit of use, you'll probably find that changing the options in the text-based desk 
accessory is faster than changing them in the control panel. 

Accessing the Desk Accessory 

To access the HardPressed Control desk accessory: 
1 While holding down the and Control keys, press the Escape key. 



60 ■ 



SIX 



THE HARDPRESSED CONTROL DESK ACCESSORY 



Desk ftccessorieT 



^I'f^r^^S^^^p lay Mode 
HardPressed Control 
Quit 




The Desk Accessories menu appears. 
2 Use the up and down arrow keys to select HardPressed Control, then press Return. 



HardPressed Control 



V EM=mtM Conpress and Expand 

V Uer if y ■ Off 



Select- ^ -» 4- -t- Cancel-Esc Saue ■ ti 



The HardPressed Control menu appears. 
3 Use the up and down arrow keys to select the option you want to change. 
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For more information about the HardPressed Status option, see Changing HardPressed 
Status on page 35. 

For more information about the Verify option, see Verifying Files After Compression on 
page 50. 

4 Use the left and right arrow keys to change the option's current setting. 

5 Press Return to save the new settings. 

tS Desk Accessor i"es~^^^^^^^^^^^^^^^^B 

^ft?^r^^^S^P lay Mode 
HardPressed Control 
Quit 




The Desk Accessories menu reappears. 

6 Press Escape to select the Quit option. 

7 Press Return to exit the Desk Accessories menu and return to your application. 

The changes you make in the HardPressed Control desk accessory are only temporary. 
When you restart your computer, the HardPressed Status and Verify options are 
restored to the settings you had previously chosen in the HardPressed control panel. 
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Compressing System Files 

While HardPressed allows you to compress any files on your disks, there are certain 
files in your System folder you should not compress. Because these files load before 
HardPressed loads when your computer starts up, GS/OS won't recognize them if they 
are compressed. The following list summarizes which files you should not compress. 

■ ProDOS 

■ System:Error.Msg 

■ System:GS.OS 

■ System:GS.OS.Dev 

■ System:Start 

■ System:Start.GS.OS 

■ System:Drivers: < All Files > 

■ System:FSTs: <A11 Files 

■ System:System.Setup: <A11 Files > 

You can safely compress files in the CDevs, Desk.Accs, FinderExtras, Fonts, Sounds, and 
Tools folders. You can also compress the P8 and Finder applications if you want. For 
best performance, compress files in your System folder using the All: LZSS profile. 

Do not compress the program named Start. You can compress Start only if you rename 
it to something else (such as Finder) after installing SetStart and a new Start program. 

If you want to create a bootable 800K disk with HardPressed installed, the following 
table lists the minimum set of files to install. You can also use the Install program to 
create a compressed system disk. Make sure HardPressed is inactive before using the 
Install program or else HardPressed will expand all the files copied during installation. 
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File Name 


Compress? 


ProDOS 


No 


BASIC. System 


No 


Icons 




FType .Apple 


Yes 


System 




Error.Msg 


No 


Finder 


Yes 


GS.OS 


No 


GS.OS.Dev 


No 


P8 


Yes 


Start 


No 


Start.GS.OS 


No 


CDevs 




HardPressed.CDV 


Yes 


Printer 


Yes 


SetStart 


Yes 


Time 


Yes 


Desk.Accs 




ControlPanel 


Yes 


HardPressed.CDA 


Yes 


Drivers 




AppleDisk3.5 


No 


AppleDislc5.25 


No 


Console. Driver 


No 


FinderExtras 




HardPressed.FXT 


Yes 


Fonts 




FastFont 


Yes 


FSTs 




Char.FST 


No 


Pro.FST 


No 


System. Setup 




HardPressed 


No 


HP.Prefs 


No 



File Name 


Compress? 


Resource.Mgr 


No 


Sys.Resources 


No 


Tool.Setup 


No 


TS2 


No 


TS3 


No 


HP.Modules 




cd.aliuff 


No 


cd.crcl6 


No 


cd.diff 


No 


cd.lzss 


No 


cd.lzw 


No 


cd.rle 


No 


P.all.flzw 


No 


P.all.lzss 


No 


P.all.lzw 


No 


P.all.rle 


No 


P.all.rlelzw 


No 


P.Faster 


No 


P.Smaller 


No 


P.StdProDOS 


No 


Tools 




T001014 


Yes 


Tooi015 


Yes 


T00IOI6 


Yes 


T00IOI8 


Yes 


Tooi019 


Yes 


T00IO2O 


Yes 


T00IO2I 


Yes 


T00IO22 


Yes 


T00IO23 


Yes 


T00IO25 


Yes 


T00IO27 


Yes 


T00IO28 


Yes 


T00IO34 


Yes 
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Trouble-shooting and Error Messages 

This appendix contains answers to questions and problems you may have regarding 
HardPressed. It also includes a description of the GS/OS error messages you may 
encounter while using the program. 

Disabling HardPressed at Startup 

If you want to disable HardPressed for any reason, there are two ways to do it. 

■ To temporarily turn off HardPressed when your system starts up, press H when the 
GS/OS startup screen appears. An X appears through the HardPressed icon to show 
that HardPressed isn't loaded. HardPressed will be loaded the next time you restart 
your computer. 

■ To permanently disable HardPressed, click the HardPressed icon in the 
System.Setup folder (inside your System folder), then choose Icon Info from the 
Special menu. Deselect the Active checkbox, then restart your computer. 
HardPressed won't load at startup until you re-select the Active checkbox in the 
Icon Info window. 



Questions and Answers 

Q . Sometimes when I choose Icon Info in the Finder, HardPressed expands the file. Why? 

A. Some files have version information stored in the resource fork. For example, getting 
Icon Info on the HardPressed CDev will display the full name of the program and a 
copyright notice. To get at this information, the resource fork must be expanded first. 
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Q . I copied the All: Adapative Hu£Gman profile out of the Goodies folder, but I can't seem 
to compress anything with it. 

A. The profiles tell HardPressed which modules to use. If the needed modules aren't 
loaded, HardPressed can't use them. By default, the Adaptive Huf&nan and Differential 
modules are marked as Inactive in the Finder You can enable them with the Finder's 
Icon Info command (select the module's icon in the System:System.Setup:HP.Modules 
folder, choose Icon Info in the Special menu, then deselect the Inactive checkbox). 
Once you have activated the module, it will be available every time you start your 
computer, and HardPressed will load it when you restart or reopen the HardPressed 
control panel. 

Q . When compressing a file with the Finder extension, why does the little document icon 
empty and then fill up? 

A. You have Verify mode turned on. The cursor empties during compression, then fills 
during the verify. When expanding, it just fills. 

Q . An X appears through the HardPressed icon each time my computer starts up, but I 
didn't press H to keep it from loading. 

A . Either HardPressed or your system software is not installed correctly. You can usually 
fix the problem by re-installing HardPressed. If HardPressed still doesn't load after re- 
installing it, re-install System 6, then re-install HardPressed. 

Q . I tried to compress some files in the Finder, but I get a message saying that HardPressed 
couldn't find anything to compress. 

A . HardPressed will not compress a file if any of the following are true: 

■ The file is already compressed. 

■ The file is less than 512 bytes in size. 
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■ The file is locked and the Handle locked files checkbox isn't selected in the 
HardPressed control panel (see page 51). 

■ The type of file selected can't be compressed by the active profile. (For example, 
the Standard profile does not compress ProDOS 8 fiiles.) 

I compressed a file in the Finder, but when I select it and choose Compression Info, it 

says it isn't compressed. 

The file is not compressible. For example, compression may have actually made the file 
larger; in these cases, HardPressed keeps the original file and discards the larger, 
"compressed" copy. 

I selected Inactive mode in the HardPressed control panel, but when I restart, it comes 
up in Expand only mode. 

HardPressed does not set the mode to Inactive in the HP.Prefs fiile. This is because you 
may have compressed files in the System folder— if HardPressed is inactive when your 
computer starts up, it won't be able to load the compressed system files. 

Error Messages 

The following are some GS/OS error messages you may encounter while using 
HardPressed. If you need to call WestCode Customer Support about an error message 
not listed here, please write down the error number before calling. 

Error $0201: Out of Memory 

HardPressed uses more memory than GS/OS alone does (which goes without saying), 
so you may run out of memory sooner. To reduce the amount of memory HardPressed 
uses, try lowering the size of the file cache in the HardPressed control panel, or turn 
the fiile cache off. See Choosing a Size for the Pile Cache on page 47 for more 
information. 



Q. 

A. 

Q. 
A. 
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If decreasing or turning oflf the file cache doesn't help, try removing desk accessories 
that you don't use very ofi:en. (You can make desk accessories inactive using the Icon 
Info command in the Finder). Inactive desk accessories don't take up any memory. 

If the first two solutions don't work, we recommend increasing the amount of memory 
in your Apple IlGS. 

Error $004A: Bad Version 

If a HardPressed file becomes damaged (perhaps because a program started writing 
data directly to the disk, or a crash occurred during an update), or a module needed to 
uncompress it is missing, GS/OS will return error $iA (Bad Version). While we're not 
really using the error code in the way it was intended, the message conveyed is the 
same: HardPressed can't read this file, and nothing the application can do will change 
it. 

Error $0045, $0046: Path Not Found (Can't create temp file) 

HardPressed is unable to create a temporary file. This will happen if the pathname for 
the temporary folder is set incorrecdy in the HardPressed control panel, or if the 
volume containing the temporary folder is offline. This message usually appears in a 
HardPressed warning dialog box, not as a GS/OS error message. See Selecting a Folder 
for Temporary Files on page 48 for more information. 

Application Limitations 

Because of the way HardPressed works, there are some programs with which it may not 
be 100% compatible. The following sections list some incompatible programs we are 
aware of For the most recent compatibility notes, read the ReadMe fiile on your 
HardPressed disk. 
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ProSel-16 



Many ProSel-l6 utility functions read the disk directly, instead of using the typical 
GS/OS calls to read and write files. This bypasses HardPressed, so ProSel can become 
confused when dealing with compressed files while HardPressed is active. To avoid 
these problems, you must use the HardPressed control panel or the HardPressed 
Control desk accessory to make HardPressed inactive before using the Utilities, 
Backup/Restore, Volume Repair, or Volume Optimization functions. 

We have used ProSel-l6 as a program launcher throughout the development of 
HardPressed without any problems. 



Make HardPressed inactive before using any of the ProSel-16 file or disk utilities. 

If you use the Utilities, Backup/Restore, Volume Repair, or Volume Optimization menus 
while HardPressed is active, your data may become corrupted. Do not try to copy 
compressed files with ProSel's utilities while HardPressed is active. Always make 
HardPressed inactive before using the ProSel-16 utilities. 



GNOBug (software that allows GNO programmers to use GSBug) is used to hook GNO 
in above GSBug. However, hooking GNO above HardPressed can cause problems. The 
correct order is HardPressed first, GNOBug second, and GSBug third. 



The CAT command will show the files as HardPressed (LBR) files instead of their 
expanded file type, but all commands and utilities will function without any problems. 




Warning 



GNOBug 



Old ORCA and APW Shells 
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of compression modules and profiles. It describes 
the encoding method used by each compression 
module and the filetypes compressed by each 
profile. 
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Technical Information 

This appendix discusses the technical aspects of the compression modules and profiles 
included with HardPressed. In the following sections, you'll learn which modules and 
profiles are best for compressing the different kinds of files you use. You don't need to 
read this to use HardPressed, but it's informative reading nonetheless. 

We designed HardPressed to be easily extensible. Instead of keeping the compression 
modules and profiles built into HardPressed, they are stored in separate files inside the 
HP.Modules folder in your System.Setup folder As new compression modules and 
profiles are produced by WestCode and third-party developers, you can take advantage 
of their functionality by simply dragging them to your HP.Modules folder. 

Compression Modules 

HardPressed uses a variety of compression modules to process different kinds of data. 
The tables on the following pages tell you about each module's advantages and 
disadvantages. Each table includes the following: 

■ the encoding method and the compression module's file name in System.Setup 

■ a description of the encoding method 

■ the best- and worst-case kinds of fiiles 

■ the encoding (compressing) speed and decoding (expanding) speed 

■ the compression ratio achieved 

■ the memory requirement 

The encoding and decoding speeds for each module are relative to the other modules. 
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16-bit CRC-CCITT 
(cd.crc16) 


Encoding speed: excellent 


Compression ratio: adds two bytes to 
the end of the file 


Decoding speed: excellent 


Memory requirements: no internal 
buffers, 8K output buffer 


This module computes a 16-bit CRC (Cyclic Redundancy Check) on the data. A CRC is a value obtained by perfonning 
computations on every byte of data in a file. If any part of a file is changed, the CRC will be different. This allows you to be 
sure that the file you are expanding is identical to the file you compressed. 

CRC doesn't actually change any of the data, so it processes very quickly. The CRC is stored at the very end of the file, so 
the file will grow by two bytes. 



Differential 
(cd.diff) 



Encoding speed: excellent 



Decoding speed: excellent 



Compression ratio: N/A 



Memory requirements: no internal 
buffers, no output buffer 



Differential encoding changes the file so that the value of each byte is the difference between it and the previous byte, so 
"1 2 3 4" becomes "111 1". Differential encoding doesn't change the size of the data; it is intended to be run as a pre- 
processor before compression. 

Differential encoding followed by full adaptive Huffman gives good compression. Faster adaptive Huffman will not do 
very well. 

Best case: sound files and musical instruments. 
Worst case: anything else. 
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RLE— Run Length Encoding 
(cd.rle) 



Encoding speed: very good 



Decoding speed: very good 



Compression ratio: poor 



Memory requirements: no internal 
buffers, 8K output buffer 



IU.E passes data through until it sees the same byte repeated several times in a row. It changes the "run" of characters into 
a three-byte code. 

RLE is useful mostly as a preprocessor before compressing with LZW or LZSS. In the best case, it makes the file smaller 
before LZW gets it, and it will prevent the data structures used by LZ compressors from filling up with long runs of the 
same character. RLE is commonly used in programs which give a slight amount of compression with no perceptible 
reduction in speed, such as Apple's Archiver backup program. 

Best case: files which have characters repeated several times in a row, such as APW source files (which have lots of spaces 
in them) and applications (which often have large regions filled with zeroes). A large file filled with zeroes compresses 
tightiy. 

Worst case: English text. Since RLE replaces characters with a three byte code, only runs of four characters can be 
compressed. This is rare in most documents that are intended for human use. 



Adaptive Huffman 
(cd.ahuff) 


Encoding speed: poor 


Compression ratio: fair 


Decoding speed: poor 


Memory requirements: 4K internal 
buffer, 4K output buffer 


This is a form of Huffman encoding that adapts to the input. The compressor replaces frequent characters with short 
codes and infrequent characters with longer codes. 

Adaptive Huf&nan doesn't do very well on most files because the data structure update routines are slow and it has to deal 
with input and output on a bit-by-bit basis. 

Best case: files composed primarily of a small set of characters. It does reasonably well on English text. 
Worse case: files with an even distribution of characters. 
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Faster Adaptive Huffman 
(cd.ahuff) 


Encoding speed: fair 


Compression ratio: fair 


Decoding speed: fair 


Memory requirements: 4K internal 
buffer, 4K output buffer 


This compressor is similar to adaptive Huffman, except it stops adapting after the first 4K of input data. Since most of the 
time is spent manipulating the data structures, compression is faster (though not quite as good). 

For English text files, this does about as well as adaptive Huffman. For other kinds of files (applications) it doesn't do 
nearly as well, and for some (differentialed sound files) it tends to fail miserably. 

Best case: same as adaptive Huffman. 

Worse case: same as adaptive Huffman, with the additional handicap of files which change drastically after the first 4K. 



12-bit LZW 
(cd.lzw) 



Encoding speed: fair 



Decoding speed: fair 



Compression ratio: very good 



Memory requirements: 30K internal 
buffer, 8K output buffer 



12-bft LZW uses the Lempel-Ziv-Welch encoding method, with a maximum code size of 12 bits. 

12-bk LZW is one of the most widely used compression methods. Variants of LZW can be found in almost all archiving 
programs (Shrinkit compresses files with RLE and LZW). The reason for this is that it typically compresses text files by 45- 
50%, and can work quickly and with a small amount of memory. 12-bft LZW isn't very fast on an Apple IlGS, but ft can be 
sped up with some simple tricks (see Faster 12-bft LZW). 

Best case: files with repeated strings, such as English text. LZW replaces common strings with symbols. 

Worst case: random data. LZW doesn't do well on raw sound files or data which has afteady been compressed (except for 
RLE and the like). 
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Faster 12-bit LZW 
(cd.lzw) 



Encoding speed; fair 



Decoding speed: good 



Compression ratio: good 



Memory requirements: 30K internal 
buffer, 8K output buffer 



This compressor is very much like 12-bit LZW, but it's enhanced to give better performance at the expense of shghtly less 
compression. 

Faster LZW uses the same memory and most of the same routines that the standard LZW compressor does. The only real 
difference is that the output codes are fixed at 12 bits instead of variable width, so the routines which deal with the codes 
are much simpler. 

Best case: see 12-bit LZW. 

Worst case: see 12-bit LZW. 



LZSS 
(cd.lzss) 



Encoding speed: very poor 



Decoding speed: very good 



Compression ratio: very good 



Memory requirements: 28K internal 
buffers, 8K output buffer 



LZSS is a different Lempel-Ziv method which takes six to ten times as long as LZW to compress data, but expands twice as 
fast. The compression is generally better than what LZW achieves. 

LZSS can't build strings as long as LZW can, but it builds longer strings sooner. The 12-bit limitation on LZW prevents it 
from doing as well as LZSS. The high speed of expansion (more than twice as fast as LZW) makes this an ideal choice for 
files which are changed rarely or not at all, such as applications. Super Hi-Res screens, text files, help files, and so on. 

Best case: files with repeated strings of characters. 

Worst case: random or akeady compressed data. 
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Profiles 

A profile tells HardPressed which compression module to use when compressing a file. 
There are two general kinds of profiles. The "intelligent" profiles, such as Standard or 
Faster, tell HardPressed to use a certain compression module depending on the 
ProDOS file type of the file being compressed. The "all" profiles, such as All: LZSS, use 
a single compression module to compress all files (regardless of file type). 

The tables on the following pages describe the types of files compressed by each 
profile. Each table contains a general category of file types (such as sound files or 
uncompressed graphic files), a list of the ProDOS file types in the category, and the 
compression modules used based on the "intelligent" profiile setting (Standard, Faster, 
or Slower). 



The Standard + ProDOS 8 profile uses the LZW module to compress files in the 
ProDOS 8 category or Generic Text or Binary category. 



Unknown or unassigned 


Faster: None 


Standard: None 


Slower: None 


100 (NON), SOD, WE, 117, $18, SIC, SlD, $IE, $l¥, $23-28, S2F-3F, $44-4F, S53, $60-6A, |6C, $70-9F, $A1-AA, SAE-AF, 
SBE. SC4. SCB-D4. $U9. SDA SDC. SDD. SDE, SDF, SE l. SE3-ED, SFl. SF2. SF3. $F4. SF5, SF6. Sr. SF8 



Pascal, CP/M, Apple /// 


Faster: None 


Standard: None 


Slower: None 


$02 (PCD), $03 (PTX), $05 (PDA), $07 (FNT), $09 (BA3), $0A (DA3), $0B (WPF), $0C (SOS), $10 (RPD), $11 (RPI), $12 
(AFD), $13 (AFM), $14 (AFR), $15 (SCL), $20 (TDM), $21 (???) (Instant Pascal source), $22 (???) (UCSD Pascal volume), 
129 (???) (Apple /// SOS dictionary), $EF (PAS) 
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ProDOS 8 


Faster: None 


Standard: None 


Slower: None 


108 (FOT), 116 (PFS), $19 (ADB), $1A (AWP), $1B (ASP), |2A (8SC), S2B (SOB), $2C (SIC), |2D (8LD), |2E (P8C), $41 
(OCR data), $43 (Peripheral data), $5F (FIN), $6B (BIO), $6D (TDR), $6E (PRE), $6F (HDV), $A0 (WP ), $DB (DBM), $EE 
(R16), $F0 (CMD), $FA (INT), $FB (WR), $FC (BAS), $FD (VAR), $FE (REL), $FF (SYS) 



Generic text or binary 


Faster: None 


Standard: None 


Slower: None 


104 (TXT), $06 (BIN) 



GS/OS Application 


Faster: None 


Standard: RLE 


Slower: LZSS 


$B1 (OBJ), $B2 (LIB), $B3 (S16), $B4 (RTL), $B5 (EXE), $BC (LDF) 



Source code 


Faster: Faster LZW 


Standard: Faster LZW 


Slower: LZW 


$B0 (SRC) 



Development utility document 


Faster: Faster LZW 


Standard: Faster LZW 


Slower: LZSS 


$5E (DVU) 



Mixed text and data (WP) files 


Faster: Faster LZW 


Standard: LZW 


Slower: LZW 


$40 (DIC), $50 (GWP), $51 (GSS), $52 (GDB), $BF (DOC) 
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Desktop Publishing 


Faster: Faster LZW 


Standard: Faster LZW 


Slower: LZW 


$54 (GDP) 



Hypermedia/multimedia 


Faster: Faster LZW 


Standard: LZW 


Slower: LZSS 


$53 (HMD), $5C (MUM) 



Sound files 


Faster: None 


Standard: None 


Slower: Diff+AHuff 


$D6 (INS), $1 


)8 (SND), Filename.SND 









Compressed data 


Faster: None 


Standard: None 


Slower: None 


$C0/$8XXX (PNT), lEO (LBR), filename.Z, filenamcARC, filename.ZOO, filename.ZIP, filename.SHK, filename.GIF, 
filename.BXY, filename.JPG 



Finder data 


Faster: None 


Standard: None 


Slower: None 


$42 (FTD), $CA (ICN) 



GS/OS System data 


Faster: None 


Standard: None 


Slower: None 


$B6 (PIF), $B7 (TIF), $B8 (NDA), $B9 (CDA), $BA (TOL), $BB (DVR), $BD (FST), $C7 (CDV), $C8 (FON), $F9 (OS) 
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Uncompressed graphic data 


Faster: Faster LZW 


Standard: LZW 


Slower: LZSS 


$5B (ANM), j!Cl (PIC), $C2 (ANI), ii!C3 (PAL), $C5 (OOG) 



Allegedly compressed graphic data 


Faster: None 


Standard: LZW 


Slower: LZSS 


IC0/W000-W003 



Miscellaneous 


Faster: None 


Standard: None 


Slower: None 


$56 (EDU), $57 (STN), 158 (HLP), $t 
$05 (MUS), $D7 (MDI), $E2 (ATK) 


9 (COM), $5A (CFG), $5D (ENT), $A 


B (GSB), $AC (TDF), $AD (BDF), $C6 (SCR), 



Sparse files 


Faster: RLE 


Standard: 

RLE + Faster LZW 


Slower: RLE + LZW 


Not filetype dependent 



Uncompressible files 


Faster: None 


Standard: None 


Slower: None 


$01 (BAD), $5A/804B, $5A/804C, $5A/804D (HardPressed preferences), $BC/400F, $BC/COOF (HardPressed compression 
module), $C9 (Finder data), $E0/800D, $E0/800E, $E0/800F (HardPressed compressed data) 
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